package com.apimanage.common.service;

import com.apimanage.common.dto.UserDTO;
import com.apimanage.common.dto.AuthDTO;
import java.util.List;

/**
 * 用户中心服务接口
 * 定义用户管理相关的核心服务方法
 * 该接口位于api-common模块，供其他模块引用，以避免循环依赖
 *
 * @author API管理平台
 */
public interface UserCenterService {

    /**
     * 根据ID获取用户信息
     */
    UserDTO getUserById(Long id);

    /**
     * 根据用户名获取用户信息
     */
    UserDTO getUserByUsername(String username);

    /**
     * 更新用户信息
     */
    boolean updateUser(UserDTO userDTO);

    /**
     * 修改密码
     */
    boolean changePassword(Long userId, String oldPassword, String newPassword);

    /**
     * 重置密码
     */
    boolean resetPassword(Long userId, String newPassword);

    /**
     * 禁用/启用用户
     */
    boolean updateUserStatus(Long userId, Integer status);

    /**
     * 分页查询用户列表
     */
    List<UserDTO> getUserList(Integer page, Integer pageSize);

    /**
     * 获取用户总数
     */
    int countUsers();

    /**
     * 用户注册
     */
    boolean registerWithAuthDTO(AuthDTO authDTO);
}